//===============================================================================
// Microsoft patterns & practices Enterprise Library Contribution
// Policy Injection Application Block
//===============================================================================

using System;
using Microsoft.Practices.Unity;
using Microsoft.Practices.Unity.InterceptionExtension;

namespace EntLibContrib.PolicyInjection.CallHandlers
{
	/// <summary>
	/// An attribute used to apply the <see cref="OneWayCallHandler"/> to the target.
	/// </summary>
	[AttributeUsage(AttributeTargets.Class | AttributeTargets.Property | AttributeTargets.Method)]
	public sealed class ThreadSafeCallHandlerAttribute : HandlerAttribute
	{
		#region Fields
		private string syncRoot;
		#endregion

		#region Properties
		/// <summary>
		/// Gets the SyncRootName used by the handler.
		/// </summary>
		/// <value>ThreadSafe name.</value>
		public string SyncRoot
		{
			get { return syncRoot; }
		}
		#endregion

		#region Construction
		/// <summary>
		/// Creates a new <see cref="ThreadSafeCallHandlerAttribute"/>.
		/// </summary>
		public ThreadSafeCallHandlerAttribute()
		{
		}

		/// <summary>
		/// Creates a new <see cref="ThreadSafeCallHandlerAttribute"/> that uses the given
		/// syncRoot name.
		/// </summary>
		/// <param name="syncRoot">SyncRoot name to use for locking.</param>
		public ThreadSafeCallHandlerAttribute(string syncRoot)
		{
			this.syncRoot = syncRoot;
		}
		#endregion

		#region Public Methods
		/// <summary>
		/// Derived classes implement this method. When called, it
		/// creates a new call handler as specified in the attribute
		/// configuration.
		/// </summary>
		/// <param name="container">The <see cref="T:Microsoft.Practices.Unity.IUnityContainer"/> to use when creating handlers,
		/// if necessary.</param>
		/// <returns>A new call handler object.</returns>
		public override ICallHandler CreateHandler(IUnityContainer container)
		{
			return new ThreadSafeCallHandler(SyncRoot, Order);
		}
		#endregion
	}
}
